home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 1999 August / SGI Freeware 1999 August.iso / dist / fw_objc.idb / usr / freeware / catman / u_man / cat1 / postlink.Z / postlink
Encoding:
Text File  |  1999-07-16  |  5.2 KB  |  133 lines
  1.  
  2.  
  3.  
  4.      ppppoooossssttttlllliiiinnnnkkkk((((1111))))       UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((JJJJuuuullll 11118888,,,, 1111999999997777))))       ppppoooossssttttlllliiiinnnnkkkk((((1111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.       postlink - Portable Object Compiler Postlink Tool
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.       ppppoooossssttttlllliiiinnnnkkkk [ options ] [ - ] [ linkmap [ outfile ] ]
  13.  
  14.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.       ppppoooossssttttlllliiiinnnnkkkk is a    tool that takes    a link map as input and    that
  16.       writes a C program to    the ssssttttddddoooouuuutttt or to oooouuuuttttffffiiiilllleeee.... The program
  17.       essentially consists of a table of all Objective-C classes
  18.       that are linked into the program (as indicated by the    link
  19.       map).     The name stems    from the fact that the C program is
  20.       then compiled    by the oooobbbbjjjjcccc driver and linked into the program
  21.       after    a first    link.  The oooobbbbjjjjccccrrrrtttt runtime can use this table
  22.       for initializing all classes.
  23.  
  24.  
  25.      AAAAUUUUTTTTOOOOMMMMAAAATTTTIIIICCCC IIIINNNNIIIITTTTIIIIAAAALLLLIIIIZZZZAAAATTTTIIIIOOOONNNN
  26.       Most UNIX oooobbbbjjjjcccc drivers are by    default    configured for
  27.       automatic initialization, and    do NOT use this    tool.
  28.       Automatic initialization determines at run-time what classes
  29.       are linked into the program, and does    not need a compile-
  30.       time generated table of classes or a double link.  It    is
  31.       still    possible to suppress automatic initialization by using
  32.       the ----ppppoooossssttttlllliiiinnnnkkkk    option.     Conversely, some non-UNIX drivers
  33.       that are configured with postlink by default,    can be used
  34.       with the ----nnnnooooPPPPoooossssttttlllliiiinnnnkkkk flag, but beware    that, in general, the
  35.       reason to configure a    driver with postlink is    that the
  36.       automatic initialization code    doesn't    work for the
  37.       particular platform.
  38.  
  39.  
  40.      EEEEXXXXAAAAMMMMPPPPLLLLEEEE
  41.       The command:
  42.  
  43.            nm a.out    | postlink > file.c
  44.  
  45.       writes a C file to file.c that can be    used by    the oooobbbbjjjjccccrrrrtttt
  46.       runtime for initialization.  The table consists of BIND
  47.       functions that need to be called for all modules that    were
  48.       compiled with    the oooobbbbjjjjcccc compiler.  Note that this includes
  49.       all modules that need    to be initialized, whether they    define
  50.       a class, or just send    an Objective-C message.
  51.  
  52.  
  53.      OOOOPPPPTTTTIIIIOOOONNNNSSSS
  54.       ----aaaa ffffiiiilllleeee
  55.            Append  file to the postlink output.  This can be used
  56.            to prepare Objective-C packages that,  when loaded with
  57.            dlopen(), automatically initialize themselves.  Classes
  58.            defined in the package will automatically register
  59.            themselves to the runtime.  The file that is appended
  60.  
  61.  
  62.  
  63.      Page 1                         (printed 6/28/99)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      ppppoooossssttttlllliiiinnnnkkkk((((1111))))       UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((JJJJuuuullll 11118888,,,, 1111999999997777))))       ppppoooossssttttlllliiiinnnnkkkk((((1111))))
  71.  
  72.  
  73.  
  74.            to the postlink output, typically contains some C code
  75.            to process the postlink output (initializers,
  76.            finalizers).
  77.  
  78.  
  79.       ----oooo ffffiiiilllleeee
  80.            Place output in    file
  81.  
  82.  
  83.       ----pppp ssssyyyymmmmbbbboooollll
  84.            Prepend    symbol to the name  _objcModules.  This    option
  85.            can be used when    building tables    of BIND    functions for
  86.            shared objects that are going to    be dynamically loaded
  87.            by a program (e.g. with dlopen()); in this case the
  88.            program needs more than just one    _objcModules table.
  89.  
  90.  
  91.       ----ffff ffffoooorrrrmmmmaaaatttt
  92.            Currently ffffoooorrrrmmmmaaaatttt    can be one of uuuunnnniiiixxxx,,,, wwwwaaaattttccccoooommmm mmmmssssvvvvcccc    iiiibbbbmmmmvvvvaaaacccc
  93.            or mmmmeeeettttrrrroooowwwweeeerrrrkkkkssss....  The default format is unix.  If the
  94.            format is uuuunnnniiiixxxx,,,, then the    input is assumed to be the
  95.            output of the nnnnmmmm    command    (preferably the    BSD nm
  96.            format).     If the    format is wwwwaaaattttccccoooommmm,,,, then the input is
  97.            assumed to be a WATCOM wwwwlllliiiinnnnkkkk link map, as generated
  98.            with ooooppppttttiiiioooonnnn mmmmaaaapppp====....
  99.  
  100.  
  101.      FFFFIIIILLLLEEEESSSS
  102.       $OBJCDIR/lib/_prelink.o     prelink stub file
  103.  
  104.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  105.       objc(1), nm(1)
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                         (printed 6/28/99)
  130.  
  131.  
  132.  
  133.